home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr15 / dvpeg28.zip / READ.ME < prev    next >
Text File  |  1993-06-29  |  12KB  |  287 lines
  1.                                      DVPEG 2.8 read.me file
  2.                                      ----------------------
  3.  
  4. This is an explanation of the function of the various programs that are
  5. in the DVPEG ZIP archive.
  6.  
  7.  
  8. Vidsetup.exe
  9. ------------
  10. The video setup program must be run before you can use dvpeg.  It is used to
  11. select and test video modes and make a list of the working modes for dvpeg to
  12. use.
  13.  
  14. *************************************************************************
  15. Note:  If your video card is not supported with DVPEG directly you may
  16.          be able to get it working with the UNIVESA.EXE program.  It is a
  17.          "universal" VESA driver.  It supports more cards than DVPEG does.
  18.          The next incarnation of DVPEG will use the graphics routines that
  19.          are in this video driver (from the SVGAkit version 3.2).
  20.                         To use this driver.  Just run UNIVESA.EXE after the machine
  21.                  has been reset.  The driver will stay in the machine until it is
  22.                  reset or turned off.  Once it is installed you can run VIDSETUP or
  23.                  DVPEG.
  24. *************************************************************************
  25.  
  26.   When the program starts up it will detect what type of video card you have
  27. and automatically enter all of the modes for that card in the user list.  You
  28. should find the hi-lighted card on the right of the screen is the same as
  29. the video card that is in your system.  The list of modes is in the lower
  30. right hand side of the screen.  Hit enter twice and you will get to that
  31. "window" (ESC will back you out).
  32.   If you have your video card manual handy delete any mode that is not listed
  33. in your manual.  If some modes that your card supports were not entered into
  34. the list then hit ESC once, arrow to the mode you want to add and hit INS.
  35. You can also add custom modes if you know a lot about your video card with
  36. the C key (poking thru the source code to DVPEG helps - ie modes.h).
  37.   To test a video mode, move to the card you want to test (up/down arrows) and
  38. then hit <enter>. This will put you onto the upper right window where you can
  39. pick from the list of video modes that that card may support.  With the
  40. up/down arrow move to the video mode that you want to test and hit space.  You
  41. should see a series of vertical bars that fade in color as they go from left
  42. to right.  If you can not see the bars or the image is junk then dvpeg will
  43. not work with that mode.
  44.   When you find what card/mode combo's work with your system you can enter it
  45. into the list by hitting <insert> when you are in the upper right mode menu.
  46. To delete an item from the list hit enter until you get to the lower right
  47. user list menu.  With the up/down arrow move to the mode you want to delete
  48. and hit <delete>.
  49.   <enter> will move you "deeper" into the menu's while <escape> will more you
  50. back out.  When you are at the video card menu and you hit <escape> you will
  51. exit the video setup program.
  52.   At this point it will ask you if you want to save the information.  If you
  53. have correctly made a list of working modes for your system then hit <y> and
  54. the file dvpeg.cfg will be created for dvpeg to use.  It contains the list of
  55. working modes and a few other things (future features).
  56.   I hope that this makes sense and you find it useable.  This is the worst
  57. part of my viewer but it will be fixed in the next version (which I am
  58. tentitively calling VIEW).
  59.  
  60.  
  61. dvpeg286.exe
  62. ------------
  63. This is a 286 version of dvpeg. It is slower but otherwise identical to the
  64. 386 version.
  65.  
  66. dvpeg.exe
  67. ---------
  68.   F1: help  (always check this as I update the program more than I do this file)
  69.  
  70.  
  71.   Advanced features
  72.   -----------------
  73.   You can save the tint, contrast, bright setting for automatic setting the
  74.   next time a file is loaded.  Use E to view the file instead of ENTER,
  75.   adjust the tint, bright, contast to your liking and hit S to save them.
  76.   To delete the settings for the picture you are viewing hit D.  These
  77.   settings are saved in the file dvpeg.vu
  78.  
  79.  
  80.   Selecting (toggling) Options
  81.   ----------------------------
  82.   Generally one letter in each line will be in upper case.  When that key
  83.   is hit the option will toggle or change.
  84.  
  85.  
  86.   file_selection screen
  87.   ---------------------
  88.   You will always see subdirectors in the file listing and can move thru the
  89.      directory tree by hitting enter when over a subdirectory or .. which will
  90.      move you out one level.
  91.  
  92.   arrow keys: move around on the list of files/directories/drives
  93.   Pg Up, Pg Dn: move up/down one screen full of files
  94.   Home: move to the top of the list of files
  95.   End: move to the end of the list of files
  96.   Enter: view the file or
  97.             move into / outof the current directory
  98.   E or e: view file using a 24 bit buffer for tint controls (used to adjust
  99.              tint controls for saving when you have a 15 or 16 bit display)
  100.   F1: help
  101.   F2: change drive - just type a single letter  ie  d
  102.   F3: change viewing defaults (dithering, show menu, smoothing ...)
  103.   F4: change mask - type in *.gif, *.jpg ... (max. of 5 masks)
  104.   F5: change sort order (ie by name, file size, date ...)
  105.   F6: type in a new directory
  106.   F7: change some less frequently used defaults
  107.   Home:  goto the top of the file list
  108.   End:   goto the end of the file list
  109.   space: select a file for slideshow viewing (turns red)
  110.   A:  select all files for slide show
  111.   s:  start slideshow
  112.   S:  run slideshow in a continous loop (any key exits, ESC exits immediately)
  113.   Del:  deletes the file that the cursor is on
  114.  
  115.  
  116.   pre_picture_viewing screen
  117.   --------------------------
  118.   F1: help - check this since it will be more accurate than this list
  119.   ESC: exit to pick another file
  120.   E: turn off end of picture beep
  121.   M: toggle this menu on/off
  122.   L: lockout SVGA (256 color modes) ie only leave hi-color or better
  123.   G: greyscale viewing of JPEGs (faster than color)
  124.   S: change/enable shrinking of the picture to fit (only works when panning is off)
  125.   D: toggle dithering on/off
  126.   Q: toggle between 1 or 2 pass quantization
  127.   P: toggle panning on/off if the picture needs it (this can take several megs
  128.          of memory [main or disk])
  129.   arrows: select a video mode (default should be the right size)
  130.  
  131.  
  132.   picture_painted screen  (some of these work with hi_color modes)
  133.   ----------------------
  134.   ESC: exit to select another file
  135.   arrows: pan across the picture (if the picture is > screen)
  136.   -,+: shrink, expand the picture (if the picture is > screen)
  137.   Pg Up: turn brightness up
  138.   Pg Dwn: turn bightness down
  139.   Home: contrast increase
  140.   End: contrast decrease
  141.   Shift (keypad) 7,4,1 adjust red tint (increase, reset, decrease)
  142.   Shift (keypad) 8,5,2 adjust green tint
  143.   Shift (keypad) 9,6,3 adjust blue tint
  144.   F1 ... F10 multiply all panning and color controls ie F2 is *2, F8 is *8
  145.   S,s: save the bright, contrast, tint controls to be used next time this
  146.          picture is viewed
  147.   D,d: delete any stored tint ...  settings for this picture
  148.   R: re-init video mode and redraw with all tint controls reset
  149.   r: re-init video mode and redraw
  150.   P: goto the previous picture
  151.   N: goto the next picture
  152.  
  153.  
  154.   Misc. comments
  155.   --------------
  156.   Hitting ESC will immediately exit from viewing a picture.
  157.   Hitting any other key will stop the slide show after the current picture
  158.      is loaded.
  159.  
  160.  
  161.  
  162. Files Generated by Using DVPEG
  163. ------------------------------
  164.  
  165.     dvpeg.cfg
  166.     ---------
  167. Vidsetup will create called dvpeg.cfg  This file stores you viewing defaults
  168. and describes your video card.  It can only be edited with vidsetup.  This
  169. file will be stored in the directory that vidsetup.exe was found in.  If you
  170. wish to have multiple copies (for different video cards, different defaults)
  171. then copy the original to the directory where you want to make a custom one.
  172. Go into the directory and run vidsetup.  If vidsetup finds a dvpeg.cfg file
  173. in the local directory it will read it and write the replacement there.
  174.  
  175.  
  176.     dvpeg.vu
  177.     ---------
  178. This file is created and updated by the viewing program.  It has a list of
  179. tint/bright/contrast defaults for individual pictures.  This file will be
  180. created in the directory that the pictures are in.  If one is not found
  181. there the program will search in the directory that the executables are in.
  182. Any new defaults will be written where-ever the file is.  If you have the
  183. pictures on CD-ROM or read-only media then you will have to:
  184.   1) Make a dvpeg.vu file on a writable directory
  185.   2) copy a dvpeg.vu file to the directory that holds the executable
  186.  
  187. This is a binary file and you should be able to merge multiples together.
  188.  
  189.  
  190.  
  191. Closing comments
  192. ----------------
  193.   Please do tell me about any problems.  Yes vidsetup could be made much
  194.   easier to use but that would take a lot of time getting information from
  195.   the video card mfg's.  I welcome any information that people can forward
  196.   to me so that I may support more video cards.
  197.  
  198.   If you are interested in the latest executables or source code you can
  199.   reach me thru my addresses.  FTP to sunee.uwaterloo.ca in directory
  200.   pub/jpeg/viewers is the easiest way to get the latest version.  If you
  201.   do not have internet access I will send out copies thru the mail.  Just
  202.   send me a letter with a donation to cover postage and disks.  Don't
  203.   forget to tell me why type of disk (5.25" or 3.5" and the format ie
  204.   360k, 1.2M, 1.44M).
  205.  
  206.  
  207.   Updates
  208.   -------
  209.   This program undergoes rapid changes at times when I have nothing better
  210.   to do.  The easiest way to get the most recent version is thru the
  211.   internet.  I work on whatever interests me at the time.  The biggest
  212.   problem is the lack of information on video cards.  I add what I can
  213.   when I get the information.  Of course I can only test the S/W on the
  214.   machine that I have (currently a Trident 8900 video card) and so offer
  215.   no guarantees.  If you make any changes I would appreciate hearing
  216.   about it so that I can offer it in future versions.
  217.  
  218.  
  219.   Donation
  220.   --------
  221.   If you find this program usefull or are requesting an update thru the mail
  222.   I would appreciate $10 or $20 Cdn.
  223.  
  224.  
  225.   Acknowledgements
  226.   ----------------
  227.   Thanks to:
  228.     Tom Lane and the IJG for their JPEG code which is the core of my viewer.
  229.         (Simtel: graphic/JPEG4386.ZIP)
  230.  
  231.     John Bridge's VGAKIT52.ZIP
  232.         (Simtel: vga/vgakit52.zip)
  233.  
  234.     Kendall Bennett (kjb@citri.edu.au)
  235.         (Simtel: vga/SVGAKT32.ZIP)
  236.  
  237.     Finn Thoegersen's VGADOC2.ZIP
  238.         (Simtel: vga/vgadoc2.zip)
  239.  
  240.      and many others for testing and providing information to make this
  241.      program what it is.
  242.  
  243.  
  244.   I can be reached thru the internet at:
  245.       praetzel@sunee.uwaterloo.ca
  246.  
  247.   or by mail at:
  248.       137 Oprington Crt.
  249.       Kitchener, Ontario
  250.       Canada
  251.       N2N 3E2
  252.  
  253.  
  254.  
  255. Copyrights, Lefts and Centers
  256. -----------------------------
  257.  
  258. Yes everything is copyrighted.  But feel free to use it.
  259.  
  260. The IJG software has a note in the readme.ijg file that is with the
  261. source code (and the message when you exit DVPEG).
  262.  
  263. I copyright my own work since eveyone else seems to be doing it  ;-)
  264.  
  265. Since I included the UNIVESA.EXE program here is the Copyright that
  266. comes with it:
  267.  
  268. SuperVGA Test Library, Copyright (C) 1992,1993 Kendall Bennett.
  269. Universal VESA TSR, Copyright (C) 1993 Kendall Bennett.
  270.  
  271. All Rights Reserved.
  272.  
  273. The SuperVGA Test Library and the Universal VESA TSR are not public domain
  274. software. They are copyrighted software, Copyright (C) 1992,1993 Kendall
  275. Bennett. It is however free software, or what some people term 'Freeware'.
  276. You may use it for whatever you wish, even using it to write public domain,
  277. freeware, shareware and commercial software. You may NOT however re-distribute
  278. modified versions of the source code nor distribute the source code for a
  279. profit. If you make any worthwhile changes to the source code, you can send
  280. them to me for inclusion in a future release.
  281.  
  282. Since this software is free, it is supplied WITHOUT ANY WARRANTY;
  283. without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  284. A PARTICULAR PURPOSE. It is supplied as it, in the hope the people
  285. will find it useful, and that it will advance the state of the art of
  286. computer software.
  287.